home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archives / ForCLI / CloseWorkBench.lha / CloseWorkBench.doc < prev    next >
Text File  |  1992-12-28  |  6KB  |  166 lines
  1.             
  2.                       CloseWorkBench v1.0
  3.                         Stephen Johnston
  4.                 sjjohnst@descartes.uwaterloo.ca
  5.  
  6.  
  7. This is a set of two utilities which open and close the Workbench
  8. screen on demand.  They are designed to be used in combination
  9. with other utilities, such as AutoPubScreen, that open their own
  10. screens and you wish to save memory by closing the Workbench
  11. screen.  It also acts as a screen blanker and keyboard lock if
  12. the Workbench is the only screen open. :-)
  13.  
  14. Please send any flames, bug reports, etc to the author.
  15.  
  16.  
  17. Background:
  18.  
  19.  
  20. I originally wrote this program in C so that I could run Term
  21. (by Olaf Barthel - best 'comm program ever) on its own screen
  22. on an Amiga 500 with only 1mb of memory.  Term didn't leave a lot
  23. of memory left on that machine, so every little bit helped.
  24. Then I bought an Amiga 1200, and had a different problem.  I
  25. wanted an 8 colour Workbench screen, but only 4 colours for CLI
  26. windows.  I had a Multiscan monitor for a while, and it was also
  27. nice to have Workbench on a DBLNTSC screen, with CLI on a non-
  28. interlaced screen so I could read it better.  I started using
  29. PSX (Steve Tibbett) to open a public screen, and opened all
  30. my CLI windows here.  I insert my "CloseWorkBench" command into
  31. the S:Shell-Startup file, and every time I hotkey a new CLI
  32. (using KCommodity, QMouse, or whatever), the Workbench would
  33. close down and I'd get my CLI on a (faster) screen with less
  34. colours.  I re-wrote in Assembler in order to return result
  35. codes and to reduce the size.  Its now about 20% of the original
  36. size.
  37.  
  38. The one problem with this is that I always had that screen open.
  39. This problem is solved by using AutoPubScreen.  (Steve Lemieux -
  40. it can be found on Aminet and is highly recommended with this
  41. program)  This program opens up a new public screen whenever it
  42. is needed.  So if you start a shell with the line
  43.  
  44.        NEWSHELL "CON:0/0/640/400/MyShell/Screen MyScreen"
  45.  
  46. the screen "MyScreen" will be opened if necessary.  Additionally,
  47. this screen will be closed automatically once all windows on the
  48. screen are closed.  Perfect!  8 colour WorkBench, 4 colour CLI,
  49. each only opened as required.
  50.  
  51.  
  52. Installation:
  53.  
  54.  
  55. Simply copy the two files to somewhere where your path can find
  56. them, such as C:
  57.  
  58.  
  59. Usage:
  60.  
  61.      CloseWorkBench - 308 bytes (91 byte version string)
  62.      
  63.        - takes no parameters or tooltypes.
  64.        - runs from an icon.  This has an neat effect if you have
  65.          an "exploding windows" program like KCommodity running!
  66.        - returns the following result codes:
  67.             0 - Workbench closed.
  68.             5 - Workbench not closed, either because it wasn't
  69.                 open or there is a "visitor" window on the
  70.                 Workbench screen.  Not really too serious.
  71.            20 - Intuition.library could not be opened.  You
  72.                 should consider this a serious error.  If you
  73.                 see this you're probably headed for a GURU
  74.                 because you've got to be in bad shape to get
  75.                 this error.
  76.         - don't close the Workbench screen if you don't have
  77.           anything else running!  (Don't say I didn't warn you!)
  78.         - once all other screens are closed, Workbench will auto-
  79.           matically re-open.  But only if a screen was open before
  80.           CloseWorkBench was started.
  81.  
  82.      OpenWorkBench - 204 bytes (91 byte version string)
  83.      
  84.         - takes no parameters
  85.         - does not run from an icon.  This would be pretty
  86.           pointless anyway.
  87.         - returns the following result codes:
  88.              0 - Workbench opened.
  89.             10 - Workbench not opened.  Either Workbench is not
  90.                  running, or their is something wrong with
  91.                  Intuition.  Consider this a fairly serious
  92.                  error.  Either user screwed up, or Intuition did.
  93.             20 - Intuition.library could not be opened.  See
  94.                  above for general comments.
  95.  
  96.  
  97. Bugs:
  98.  
  99.  
  100. Closing the Workbench screen when it is the only screen opened may
  101. result in an unusable system.  If you can hotkey some other
  102. program active, you will be OK.  If not, you must give the Amiga a
  103. three finger salute.  (Ctrl-Amiga-Amiga)  This is _NOT_ a bug.  It
  104. is a "KeyBoard / Screen Blanker / Lock"  Under DOS 1.3 it also
  105. becomes a mouse excerciser; under DOS 2.04 and 3.0 it becomes a
  106. mouse blanker.  I suppose this could be fixed by checking to see
  107. whether other screens are open...
  108.  
  109. As the RKM's say, "The name of this function is improperly
  110. spelled.  Should be (Open)CloseWorkbench."*  I wouldn't worry
  111. about this too much if your using AmigaDOS; it takes your input
  112. either way. :-)  Tested on an Amiga 500 (512K chip, 512 fast,
  113. ECS, DOS 2.04 & 1.3) and Amiga 1200 (2mb chip, AGA, DOS 3.0)
  114.  
  115.     *Amiga RKM Manual, Includes and AutoDocs, 3rd edition,
  116.      pg315.
  117.  
  118.  
  119. Legal:
  120.  
  121.  
  122. The author cannot and will not take any responsibility for any
  123. damaged software or hardware caused by the use of these programs.
  124. The are distributed to the general public as freely-distributable
  125. shareware.  There is no fee for its use, but if you wish to send
  126. something to the author, (who is a starving student) he would be
  127. eternally grateful :-)  There is no copyright on included soft-
  128. ware, you can do as you wish.  If you do make any modifications to
  129. either program, I would like you to send me a copy.  Source code
  130. is available on request, but can be summarized in the following:
  131.  
  132.     Open Intuition, jsr _LVOCloseWorkBench, Close Intuition
  133.  
  134. (plus Workbench startup)
  135.  
  136.  
  137. History:
  138.  
  139.   v1.0 - first (and probably only) public release.  Written in
  140.          Assembler.
  141.   v0.9 - not publically released.  Written in C.
  142.  
  143.  
  144. Credits:
  145.  
  146.  
  147. Richard Desjardine - the artist for the icon.
  148. Steve Lemieux      - the author of AutoPubScreen
  149.  
  150.  
  151. Author:
  152.  
  153.  
  154. I am a University of Waterloo student, but as I am in co-op, I am
  155. only at school on alternating four-month cycles.  Mail will
  156. always reach me on Internet, but unless I get access to Internet
  157. on my next work term, I won't be replying to mail between Sept.
  158. '93 and Dec. '93!  Snail mail may be faster then; scary!
  159.  
  160.                      Stephen Johnston
  161.              sjjohnst@descartes.uwaterloo.ca
  162.                  170 University Ave. West
  163.                          #12-198
  164.                     Waterloo, Ontario
  165.                          N2L 3E9
  166.